home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / prog / vc150.zip / MANUAL.DOC < prev    next >
Text File  |  1992-05-06  |  34KB  |  899 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                    Visual Compare
  16.  
  17.                                     Version 1.50
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                      A file comparison utility for programmers.
  49.  
  50.  
  51.         Copyright Notice
  52.  
  53.         Copyright (C) John R. Whitney 1991, 1992
  54.         All rights reserved.
  55.  
  56.  
  57.         Trademarks
  58.  
  59.         CompuServe is a registered trademark of CompuServe, Inc.
  60.  
  61.         IBM is a registered trademark of International Business Machines
  62.         Corporation.
  63.  
  64.         Lotus is a registered trademark of Lotus Development Corporation.
  65.  
  66.         Intel is a registered trademark of Intel Corporation.
  67.  
  68.         Microsoft is a registered trademark of Microsoft Corporation.
  69.  
  70.  
  71.         Disclaimer and Agreement
  72.  
  73.         Visual Compare is supplied as is, without any warranty.  To the
  74.         extent permitted under applicable law, Whitney Software, Inc.
  75.         disclaims all warranties, either express or implied, including but
  76.         not limited to implied warranties of merchantability and fitness for
  77.         a particular purpose.
  78.  
  79.         In no event shall Whitney Software, Inc. be liable for any damages
  80.         whatsoever (including, without limitation, damages for loss of
  81.         business profits, business interruption, loss of business
  82.         information, or other pecuniary loss) arising out of the use of or
  83.         inability to use this Whitney Software, Inc. product, even if Whitney
  84.         Software, Inc. has been advised of the possibility of such damages.
  85.         Some states do not allow the exclusion of liability for consequential
  86.         or incidental damages, so the above limitation may not apply to you.
  87.  
  88.         Visual Compare is a "shareware program" and is provided at no charge
  89.         to the user for evaluation.  Feel free to share it with your friends,
  90.         but you may not give it away altered or as part of another system.
  91.         The essence of "user-supported" software is to provide personal
  92.         computer users with quality software without high prices, and yet to
  93.         provide incentive for programmers to continue to develop new
  94.         products.  If you find this program useful and find that you are
  95.         using Visual Compare and continue to use Visual Compare after a
  96.         reasonable trial period, you must make a registration payment of $30
  97.         to Whitney Software, Inc.  The $30 registration fee will license one
  98.         copy for use on any one computer at any one time.  You must treat
  99.         this software just like a book.  An example is that this software may
  100.         be used by any number of people and may be freely moved from one
  101.         computer location to another, so long as there is no possibility of
  102.         it being used at one location while it's being used at another.  Just
  103.         as a book cannot be read by two different people at the same time.
  104.  
  105.  
  106.         Commercial users of Visual Compare must register and pay for their
  107.         copies of Visual Compare within 30 days of first use or their license
  108.         is withdrawn.  See the file LICENSE.DOC for a site-license agreement.
  109.  
  110.         Anyone distributing Visual Compare for any kind of remuneration must
  111.         first contact Whitney Software, Inc. for authorization.
  112.  
  113.         You are encouraged to pass a copy of Visual Compare along to your
  114.         friends for evaluation.  Please encourage them to register their copy
  115.         if they find that they can use it.  All registered users will receive
  116.         a copy of the latest version of Visual Compare.
  117.  
  118.  
  119.         Technical Support
  120.  
  121.         If you have any questions or comments regarding Visual Compare,
  122.         please send them to CompuServe ID 70661,3463 or:
  123.  
  124.         Whitney Software, Inc.
  125.         P.O. Box 4999
  126.         Walnut Creek, CA 94596 USA
  127.  
  128.  
  129.         Table of Contents
  130.         _____________________________________________________________________
  131.  
  132.  
  133.         Introduction ...................................................... 1
  134.  
  135.         Starting Visual Compare ........................................... 2
  136.  
  137.         Visual Mode ...................................................... 14
  138.  
  139.         Miscellaneous Notes .............................................. 15
  140.  
  141.         Version History .................................................. 16
  142.  
  143.  
  144.         Introduction                                                        1
  145.         _____________________________________________________________________
  146.  
  147.  
  148.         This manual describes how to use the Visual Compare program to
  149.         compare two program source files.  This manual and the Visual Compare
  150.         program were written for programmers.
  151.  
  152.         Using Visual Compare's visual mode you can easily see the differences
  153.         between two program source files and you can also selectively discard
  154.         differences in order to quickly undo some of the changes that were
  155.         made.
  156.  
  157.         Visual Compare requires an IBM Personal Computer or 100% compatible
  158.         running DOS version 2.1 or later.
  159.  
  160.         Visual Compare uses a compare algorithm that has been mathematically
  161.         proven to always produce a shortest possible sequence of insertions
  162.         and deletions that will convert file one to file two.
  163.  
  164.  
  165.         Starting Visual Compare                                             2
  166.         _____________________________________________________________________
  167.  
  168.  
  169.         There are two ways to control the start of Visual Compare:
  170.  
  171.         1. Through arguments specified on the Visual Compare command line.
  172.  
  173.         2. Through commands specified in the Visual Compare initialization
  174.            file.
  175.  
  176.  
  177.         Visual Compare Command Line
  178.  
  179.         Run Visual Compare with no arguments to see a list of the available
  180.         command line arguments or to have Visual Compare prompt for
  181.         arguments.
  182.  
  183.         The form of the Visual Compare command line is as follows:
  184.  
  185.              VCOMP fileone filetwo [options]
  186.  
  187.  
  188.         VCOMP
  189.  
  190.         The name of the program module.
  191.  
  192.  
  193.         fileone
  194.  
  195.         The first of two files you wish to compare.
  196.  
  197.  
  198.         filetwo
  199.  
  200.         The second of two files you wish to compare.
  201.  
  202.  
  203.         If fileone or filetwo ends with a backslash (\) or colon (:) symbol,
  204.         the filename (file name and optional extension) from the other
  205.         fileone or filetwo command line argument is appended.  This can be
  206.         convenient if file one and file two are in different subdirectories
  207.         and have the same filename.  For example:
  208.  
  209.              VCOMP \OLD\ \NEW\SUPER.C
  210.  
  211.         is equivalent to
  212.  
  213.              VCOMP \OLD\SUPER.C \NEW\SUPER.C
  214.  
  215.  
  216.         Starting Visual Compare                                             3
  217.         _____________________________________________________________________
  218.  
  219.  
  220.         If fileone or filetwo has a file name consisting of an asterisk (*)
  221.         symbol, the file name from the other fileone or filetwo command line
  222.         argument is substituted.  For example:
  223.  
  224.              VCOMP *.BAK SUPER.C
  225.  
  226.         is equivalent to
  227.  
  228.              VCOMP SUPER.BAK SUPER.C
  229.  
  230.  
  231.         options
  232.  
  233.         The following options may be specified with a leading / or -,
  234.         whichever you prefer:
  235.  
  236.         /B
  237.  
  238.         Same as the BLACKANDWHITE initialization file command.
  239.  
  240.         Use /B to tell Visual Compare that you have a monochrome display
  241.         attached to your computer.
  242.  
  243.         Visual Compare can usually determine whether you have a color or
  244.         monochrome display.  If you have a color display, Visual Compare
  245.         takes advantage of this and uses colors on the screen.
  246.  
  247.         However, if you have a CGA (Color Graphics Adapter), Visual Compare
  248.         can't tell whether you have a monochrome or color display.  Since
  249.         Visual Compare will assume you have a color display, you may wish to
  250.         use /B to tell Visual Compare otherwise.
  251.  
  252.  
  253.         /Tn
  254.  
  255.         2-64
  256.         Default value: 8
  257.  
  258.         Same as the TABWIDTH initialization file command.
  259.  
  260.         Specifies the tab width to be used when expanding tabs, compressing
  261.         spaces, or shifting the display right and left with the Tab and
  262.         Shift-Tab keys.
  263.  
  264.  
  265.         /25
  266.  
  267.         Displays 25 lines in visual mode.
  268.  
  269.  
  270.         Starting Visual Compare                                             4
  271.         _____________________________________________________________________
  272.  
  273.  
  274.         /43
  275.  
  276.         Displays 43 lines in visual mode if you have an EGA (Enhanced
  277.         Graphics Adapter).
  278.  
  279.  
  280.         /50
  281.  
  282.         Displays 50 lines in visual mode if you have a VGA (Video Graphics
  283.         Array).
  284.  
  285.  
  286.         /S[-]
  287.  
  288.         Writes an edit script to standard output that will consist of a
  289.         shortest possible sequence of insertions and deletions that will
  290.         convert file one to file two.
  291.  
  292.         Specify /S- to write the edit script in reverse order (from the end
  293.         of file to the beginning of file).  This can be useful if you are
  294.         using an editor to convert file one to file two using the edit
  295.         script, since modifying the end of file one will not effect the line
  296.         numbers in the edit script that refer to earlier lines in file one.
  297.  
  298.  
  299.         /C
  300.  
  301.         Writes a composite file to standard output that is the same as the
  302.         composite file displayed in visual mode except that strings are used
  303.         to delimit text unique to file one or file two instead of colors.
  304.  
  305.         Use the ONESTART, ONEEND, TWOSTART, and TWOEND initialization file
  306.         commands to specify the strings used to delimit text unique to file
  307.         one or file two.  By default, ONESTART equals "$$$$$  fileone START
  308.         $$$$$", ONEEND equals "$$$$$  fileone END  $$$$$", TWOSTART equals
  309.         "$$$$$  filetwo START  $$$$$", and TWOEND equals "$$$$$  filetwo END
  310.         $$$$$."  Where "fileone" and "filetwo" represent the fileone and
  311.         filetwo command line arguments.
  312.  
  313.         One reason you might use this option is to run Visual Compare from
  314.         within your editor in order to display output similar to that
  315.         displayed in visual mode, in an editor window while you edit file two
  316.         or file one in another editor window.
  317.  
  318.  
  319.         Starting Visual Compare                                             5
  320.         _____________________________________________________________________
  321.  
  322.  
  323.         /D
  324.  
  325.         Writes a file to standard output that consists of information about
  326.         each difference.  The information consists of the corresponding file
  327.         positions for file one and file two, whether the difference is an
  328.         insertion or deletion, and the number of lines inserted or deleted.
  329.  
  330.         You might use this option to interface a program of your own design
  331.         to Visual Compare.
  332.  
  333.  
  334.         /En
  335.  
  336.         0-32736
  337.         Default value: 32736
  338.  
  339.         The edit distance is defined as the length of a shortest possible
  340.         sequence of insertions and deletions that will convert file one to
  341.         file two.
  342.  
  343.         Use /En to set the maximum edit distance.  If you specify a value
  344.         greater than 32736, Visual Compare will use 32736.  If while
  345.         comparing files the maximum edit distance is exceeded, Visual Compare
  346.         will display an appropriate message and abort.
  347.  
  348.         Use this option if you are comparing files that may be too different
  349.         for the comparison to be useful and you don't want to wait for Visual
  350.         Compare to complete the comparison if the comparison won't be useful.
  351.  
  352.  
  353.         /I
  354.  
  355.         Same as the IGNORE initialization file command.
  356.  
  357.         Ignores leading space and tab characters when comparing lines.  Use
  358.         /I if you are not interested in changes in the indentation of lines.
  359.  
  360.  
  361.         /K
  362.  
  363.         Same as the CASE initialization file command.
  364.  
  365.         Considers upper-case and lower-case letters equivalent when comparing
  366.         lines.
  367.  
  368.  
  369.         Starting Visual Compare                                             6
  370.         _____________________________________________________________________
  371.  
  372.  
  373.         /Z
  374.  
  375.         Visual Compare was designed to perform a line-oriented comparison on
  376.         two program source files.  It is possible for Visual Compare to
  377.         compare two files that are not the same at the byte level and report
  378.         that they are identical.  This can happen for six reasons.  First,
  379.         the lines in the files are not all delimited in the same manner.  For
  380.         example, lines in one file are delimited by Cr and lines in the other
  381.         file by Cr-Lf.  Second, end-of-file characters (Ctrl-Z) can cause
  382.         this to happen, because end-of-file characters are normally discarded
  383.         and files are not normally read past the first end-of-file character.
  384.         Third, tab characters can cause this to happen, because tab
  385.         characters are normally expanded to spaces before the comparison
  386.         takes place.  Fourth, trailing space and tab characters at the end of
  387.         lines can cause this to happen, because, by default, trailing space
  388.         and tab characters at the end of lines are discarded before the
  389.         comparison takes place.  (To change the default, see the TRAILING
  390.         initialization file command.)  Fifth, the /I command line option or
  391.         the IGNORE initialization file command can cause this to happen,
  392.         because they tell Visual Compare to ignore leading space and tab
  393.         characters when comparing lines.  Sixth, the /K command line option
  394.         or the CASE initialization file command can cause this to happen,
  395.         because they tell Visual Compare to consider upper-case and
  396.         lower-case letters equivalent when comparing lines.
  397.  
  398.         Use /Z to determine if two files are identical at the byte level.
  399.         This option tells Visual Compare to not discard line delimiters, to
  400.         not discard end-of-file characters and to read any characters past
  401.         end-of-file characters, to not expand tab characters, to not discard
  402.         trailing space and tab characters at the end of lines, to ignore the
  403.         /I command line option or the IGNORE initialization file command, and
  404.         to ignore the /K command line option or the CASE initialization file
  405.         command.  Visual Compare will still perform a line-oriented
  406.         comparison.  Visual Compare will also ignore the /C, /S, and /D
  407.         command line options and will enter visual mode if the files are not
  408.         identical.
  409.  
  410.  
  411.         Visual Compare Initialization File
  412.  
  413.         Visual Compare automatically processes an initialization file called
  414.         VCOMP.INI at the start of execution.
  415.  
  416.         Visual Compare first looks for VCOMP.INI in the current working
  417.         directory.  If it doesn't find VCOMP.INI, it next looks in the
  418.         directories specified by the PATH environment variable.
  419.  
  420.  
  421.         Starting Visual Compare                                             7
  422.         _____________________________________________________________________
  423.  
  424.  
  425.         The initialization file commands can be abbreviated.  For example,
  426.         the TABSOUT command can be entered as TABS, TABSO, TABSOU, or
  427.         TABSOUT.  The shortest legal abbreviation for a command is indicated
  428.         by showing that portion of the command in uppercase and the rest of
  429.         the command in lowercase.
  430.  
  431.         Some of the initialization file commands have command line option
  432.         counterparts.  If both the initialization file command and the
  433.         corresponding command line option are specified, the command line
  434.         option will override.
  435.  
  436.         The available initialization file commands are as follows:
  437.  
  438.         Attributes
  439.  
  440.         Use ATTRIBUTES to control the colors Visual Compare uses on the
  441.         screen.
  442.  
  443.         An attribute value is associated with each type of field that Visual
  444.         Compare displays.  The following table lists the seven different
  445.         field types displayed by Visual Compare.  Use ATTRIBUTES to specify
  446.         an attribute value for each field type, in the order of the table
  447.         below.
  448.  
  449.         Field                Description
  450.         ----------------------------------------------------------
  451.         Common               lines common to file one and file two
  452.         Delete               lines deleted from file one
  453.         Insert               lines inserted from file two
  454.         Function             function key and file name lines
  455.         Window               help and prompt windows
  456.         Error                error message windows
  457.         Key                  keys in help and prompt windows
  458.  
  459.         Attribute values are numbers ranging from 0 to 255.  Different
  460.         attribute values cause text to appear in different colors,
  461.         highlighted, blinking, etc.  On most display adapters that handle
  462.         color, you can use the following table to determine the attribute
  463.         value corresponding to a given color.  Add the number corresponding
  464.         to the desired foreground color to the number corresponding to the
  465.         desired background color.  To also get blinking, add 128.
  466.  
  467.  
  468.         Starting Visual Compare                                             8
  469.         _____________________________________________________________________
  470.  
  471.  
  472.         Foreground           Background
  473.         -------------------------------
  474.         0 black              0 black
  475.         1 blue               16 blue
  476.         2 green              32 green
  477.         3 cyan               48 cyan
  478.         4 red                64 red
  479.         5 magenta            80 magenta
  480.         6 brown              96 brown
  481.         7 white              112 white
  482.         8 gray
  483.         9 light blue
  484.         10 light green
  485.         11 light cyan
  486.         12 light red
  487.         13 light magenta
  488.         14 yellow
  489.         15 bright white
  490.  
  491.         On a MDA (Monochrome Display Adapter), the available attribute values
  492.         are 7 for normal text, 15 for highlighted text, 65 for underlined
  493.         text, and 112 for reverse video text.  To also get blinking, add 128
  494.         to any of these values.
  495.  
  496.         Examples:
  497.  
  498.              ATTRIBUTES 27 28 26 30 63 79 15
  499.  
  500.         The default attribute values used by Visual Compare on a CGA (Color
  501.         Graphics Adapter), an EGA (Enhanced Graphics Adapter), or a VGA
  502.         (Video Graphics Array).
  503.  
  504.              ATTRIBUTES 7 112 15 7 112 112 15
  505.  
  506.         The default attribute values used by Visual Compare on a MDA
  507.         (Monochrome Display Adapter).
  508.  
  509.  
  510.         Starting Visual Compare                                             9
  511.         _____________________________________________________________________
  512.  
  513.  
  514.         Blackandwhite
  515.  
  516.         Same as the /B command line option.
  517.  
  518.         Use BLACKANDWHITE to tell Visual Compare that you have a monochrome
  519.         display attached to your computer.
  520.  
  521.         Visual Compare can usually determine whether you have a color or
  522.         monochrome display.  If you have a color display, Visual Compare
  523.         takes advantage of this and uses colors on the screen.
  524.  
  525.         However, if you have a CGA (Color Graphics Adapter), Visual Compare
  526.         can't tell whether you have a monochrome or color display.  Since
  527.         Visual Compare will assume you have a color display, you may wish to
  528.         use BLACKANDWHITE to tell Visual Compare otherwise.
  529.  
  530.  
  531.         Case
  532.  
  533.         Same as the /K command line option.
  534.  
  535.         Use CASE to tell Visual Compare to consider upper-case and lower-case
  536.         letters equivalent when comparing lines.
  537.  
  538.  
  539.         ENdofline
  540.  
  541.         CRLF, CR, or LF
  542.         Default value: CRLF
  543.  
  544.         Use ENDOFLINE to tell Visual Compare the line delimiter to use when
  545.         the composite file is written to disk by the F2 write function.  If
  546.         Visual Compare is started with the /Z command line option, it will
  547.         not discard the line delimiters in file one and file two and will
  548.         write them to the composite file, instead of using the line delimiter
  549.         specified by ENDOFLINE.
  550.  
  551.  
  552.         Starting Visual Compare                                            10
  553.         _____________________________________________________________________
  554.  
  555.  
  556.         EXPanded
  557.  
  558.         YES or NO
  559.  
  560.         Visual Compare keeps the contents of the files you are comparing in
  561.         memory.  Visual Compare can use up to four megabytes of DOS and EMS
  562.         (Lotus-Intel-Microsoft Expanded Memory Specification, version 3.0 or
  563.         later) memory or DOS and XMS (eXtended Memory Specification) memory
  564.         to store your files.  If Visual Compare detects that EMS memory is
  565.         present in your system, it will automatically use it.  If EMS memory
  566.         is not detected and XMS memory is detected, Visual Compare will
  567.         automatically use XMS memory.
  568.  
  569.         Use EXPANDED NO to tell Visual Compare to ignore any EMS memory in
  570.         your system, and to use only DOS and possibly XMS memory.  You may
  571.         need to use EXPANDED NO if your EMS driver is not compatible with
  572.         Visual Compare.  You may also want to use EXPANDED NO for performance
  573.         reasons.
  574.  
  575.  
  576.         EXTended
  577.  
  578.         YES or NO
  579.  
  580.         Visual Compare keeps the contents of the files you are comparing in
  581.         memory.  Visual Compare can use up to four megabytes of DOS and EMS
  582.         (Lotus-Intel-Microsoft Expanded Memory Specification, version 3.0 or
  583.         later) memory or DOS and XMS (eXtended Memory Specification) memory
  584.         to store your files.  If Visual Compare detects that EMS memory is
  585.         present in your system, it will automatically use it.  If EMS memory
  586.         is not detected and XMS memory is detected, Visual Compare will
  587.         automatically use XMS memory.
  588.  
  589.         Use EXTENDED NO to tell Visual Compare to ignore any XMS memory in
  590.         your system, and to use only DOS and possibly EMS memory.  You may
  591.         need to use EXTENDED NO if your XMS driver is not compatible with
  592.         Visual Compare.  You may also want to use EXTENDED NO for performance
  593.         reasons.
  594.  
  595.  
  596.         Height
  597.  
  598.         25, 43, or 50
  599.  
  600.         Use HEIGHT to tell Visual Compare how many lines to display in visual
  601.         mode.  You must have either an EGA (Enhanced Graphics Adapter) or a
  602.         VGA (Video Graphics Array) for this command to have any effect.
  603.  
  604.  
  605.         Starting Visual Compare                                            11
  606.         _____________________________________________________________________
  607.  
  608.  
  609.         Ignore
  610.  
  611.         Same as the /I command line option.
  612.  
  613.         If you are not interested in changes in the indentation of lines, use
  614.         IGNORE to tell Visual Compare to ignore leading space and tab
  615.         characters when comparing lines.
  616.  
  617.  
  618.         SHadow
  619.  
  620.         YES or NO
  621.  
  622.         Use SHADOW to tell Visual Compare whether or not windows should have
  623.         shadows.
  624.  
  625.  
  626.         SNowcontrol
  627.  
  628.         YES or NO
  629.  
  630.         The IBM Color Graphics Adapter (CGA) requires special programming to
  631.         prevent "snow" from appearing on the screen when a program changes
  632.         the contents of the screen.  The special programming slows down
  633.         screen updating and is not necessary for most other display adapters.
  634.         If Visual Compare detects a MDA (Monochrome Display Adapter), an EGA
  635.         (Enhanced Graphics Adapter), or a VGA (Video Graphics Array), it does
  636.         not "desnow."  If Visual Compare detects a CGA, it will try to
  637.         determine whether "desnowing" is necessary.
  638.  
  639.         If you suspect that Visual Compare is "desnowing" when it is not
  640.         necessary, you may want to use SNOWCONTROL NO which will allow Visual
  641.         Compare to run faster.
  642.  
  643.         If your computer "locks up" when you run Visual Compare, use
  644.         SNOWCONTROL NO.
  645.  
  646.         If Visual Compare incorrectly determines that your CGA does not
  647.         require "desnowing", you can force Visual Compare to "desnow" by
  648.         using SNOWCONTROL YES.
  649.  
  650.  
  651.         Starting Visual Compare                                            12
  652.         _____________________________________________________________________
  653.  
  654.  
  655.         TABSout
  656.  
  657.         Use TABSOUT to tell Visual Compare to compress spaces in the
  658.         composite file to tab characters (using the default tab width of 8 or
  659.         the tab width specified by the TABWIDTH initialization file command
  660.         or the /Tn command line option) before writing the composite file to
  661.         disk.  Spaces appearing after the first single or double quote on a
  662.         line are not compressed and single spaces are not changed to tab
  663.         characters.
  664.  
  665.         TABSOUT effects the composite file written to disk by the visual mode
  666.         F2 write function and has no effect on the composite file written to
  667.         standard output by the /C command line option.
  668.  
  669.  
  670.         TABWidth
  671.  
  672.         2-64
  673.         Default value: 8
  674.  
  675.         Same as the /Tn command line option.
  676.  
  677.         Specifies the tab width to be used when expanding tabs, compressing
  678.         spaces, or shifting the display right and left with the Tab and
  679.         Shift-Tab keys.
  680.  
  681.  
  682.         TRailing
  683.  
  684.         YES or NO
  685.         Default value: YES
  686.  
  687.         Use TRAILING to tell Visual Compare whether or not trailing space and
  688.         tab characters at the end of lines should be discarded.
  689.  
  690.  
  691.         ONEStart
  692.  
  693.         "string" or 'string'
  694.         Default value: "$$$$$  fileone START  $$$$$"
  695.  
  696.         If the /C command line option is specified, ONESTART specifies the
  697.         string to be written to standard output at the start of text that is
  698.         unique to file one.  The "fileone" in the default value represents
  699.         the fileone command line argument.
  700.  
  701.  
  702.         Starting Visual Compare                                            13
  703.         _____________________________________________________________________
  704.  
  705.  
  706.         ONEEnd
  707.  
  708.         "string" or 'string'
  709.         Default value: "$$$$$  fileone END  $$$$$"
  710.  
  711.         If the /C command line option is specified, ONEEND specifies the
  712.         string to be written to standard output at the end of text that is
  713.         unique to file one.  The "fileone" in the default value represents
  714.         the fileone command line argument.
  715.  
  716.  
  717.         TWOStart
  718.  
  719.         "string" or 'string'
  720.         Default value: "$$$$$  filetwo START  $$$$$"
  721.  
  722.         If the /C command line option is specified, TWOSTART specifies the
  723.         string to be written to standard output at the start of text that is
  724.         unique to file two.  The "filetwo" in the default value represents
  725.         the filetwo command line argument.
  726.  
  727.  
  728.         TWOEnd
  729.  
  730.         "string" or 'string'
  731.         Default value: "$$$$$  filetwo END  $$$$$"
  732.  
  733.         If the /C command line option is specified, TWOEND specifies the
  734.         string to be written to standard output at the end of text that is
  735.         unique to file two.  The "filetwo" in the default value represents
  736.         the filetwo command line argument.
  737.  
  738.  
  739.         Working
  740.  
  741.         YES or NO
  742.  
  743.         Use WORKING to tell Visual Compare whether or not to display the
  744.         "Working" message.
  745.  
  746.  
  747.         Here is an example initialization file:
  748.  
  749.              CASE
  750.              EXP NO
  751.              TABW 4
  752.  
  753.         Consider upper-case and lower-case letters equivalent when comparing
  754.         lines, ignore any EMS memory in your system, and use a tab width of
  755.         4.
  756.  
  757.  
  758.         Visual Mode                                                        14
  759.         _____________________________________________________________________
  760.  
  761.  
  762.         Visual Compare can be run in batch mode by using the /C, /S, or /D
  763.         command line option.  However, most of the time you will probably run
  764.         Visual Compare in visual mode.  In visual mode you can easily see the
  765.         differences between two program source files and you can also
  766.         selectively discard differences in order to quickly undo some of the
  767.         changes that were made.
  768.  
  769.         If the /C, /S, or /D command line option is not given, Visual Compare
  770.         will enter visual mode.  In visual mode you will be presented with a
  771.         scrollable display of a composite of file one and file two.  The
  772.         composite file consists of lines that are common to file one and file
  773.         two, lines unique to file one (deleted from file one), and lines
  774.         unique to file two (inserted from file two).  Invoke the F1 help
  775.         function to see a list of the available functions and their keys.
  776.  
  777.         To selectively discard differences, use the F7 remove one function,
  778.         the F8 remove two function, the Del key, and the Minus key to remove
  779.         insertions and deletions from the composite file.  Then invoke the F2
  780.         write function to write the modified composite file to disk.  All
  781.         lines in the composite file except those that have been removed will
  782.         be written to disk.  When you invoke the F2 write function, you will
  783.         be prompted for a composite file name.
  784.  
  785.         Use the F5 show/hide function to display insertions and deletions
  786.         that have been removed.  Use the F4 number function to mark the
  787.         removed insertions and deletions.  Use the Shift-F7 key, the Shift-F8
  788.         key, the Ins key, and the Plus key to unremove insertions and
  789.         deletions.  To use the Ins or Plus key to unremove an insertion or
  790.         deletion, you must first position the cursor on the removed insertion
  791.         or deletion (the removed insertion or deletion must be displayed with
  792.         the F5 show/hide function).
  793.  
  794.         If there are lines that are too long to be completely displayed, use
  795.         the right and left arrow keys, the End key, and the Home key to
  796.         horizontally scroll the display.  The End key will scroll the display
  797.         so that the last character of the longest displayed line is visible.
  798.  
  799.  
  800.         Miscellaneous Notes                                                15
  801.         _____________________________________________________________________
  802.  
  803.  
  804.         Lines in file one and file two can be delimited with Cr, Lf, or
  805.         Cr-Lf.  The maximum allowed line length in file one and file two is
  806.         2048 characters.  The maximum number of lines that file one and file
  807.         two each can contain is 16368.  The maximum number of lines that the
  808.         composite file can contain is 16368.
  809.  
  810.         Visual Compare will normally terminate with a return code of 1.
  811.         However, if Visual Compare determines that file one and file two are
  812.         identical, it will display an appropriate message and terminate with
  813.         a return code of 0.  Also, if Visual Compare encounters an error
  814.         condition while not in visual mode, it will display an appropriate
  815.         message and terminate with a return code of 2.
  816.  
  817.  
  818.         Version History                                                    16
  819.         _____________________________________________________________________
  820.  
  821.  
  822.         Version 1.32
  823.  
  824.         Released March 5, 1992.
  825.  
  826.         First shareware version.
  827.  
  828.  
  829.         Version 1.40
  830.  
  831.         Released March 20, 1992.
  832.  
  833.  
  834.         New Features
  835.  
  836.         1. Support for XMS (eXtended Memory Specification) memory.
  837.  
  838.         2. The maximum allowed line length in file one and file two was
  839.            increased from 255 to 2048 characters.
  840.  
  841.         3. The ability to consider upper-case and lower-case letters
  842.            equivalent when comparing lines.  (See the /K command line
  843.            option.)
  844.  
  845.         4. The ability to not discard trailing space and tab characters at
  846.            the end of lines.  (See the TRAILING initialization file command.)
  847.  
  848.         5. The ability to substitute for a file name consisting of an
  849.            asterisk (*) the file name from the other fileone or filetwo
  850.            command line argument.
  851.  
  852.         6. The ability to substitute the fileone command line argument for
  853.            "fileone" in strings specified by the ONESTART and ONEEND
  854.            initialization file commands.  The ability to substitute the
  855.            filetwo command line argument for "filetwo" in strings specified
  856.            by the TWOSTART and TWOEND initialization file commands.
  857.  
  858.         7. The termination return codes were changed.
  859.  
  860.  
  861.         Version History                                                    17
  862.         _____________________________________________________________________
  863.  
  864.  
  865.         Version 1.50
  866.  
  867.         Released May 6, 1992.
  868.  
  869.  
  870.         New Features
  871.  
  872.         1. The ability to prompt for arguments when Visual Compare is run
  873.            with no arguments.
  874.  
  875.         2. The Shift-Del key, used to remove insertions and deletions from
  876.            the composite file, was changed to the Minus key.  The Shift-Ins
  877.            key, used to unremove insertions and deletions, was changed to the
  878.            Plus key.
  879.  
  880.         3. The Shift-F7 key will unremove all deletions from the composite
  881.            file.  The Shift-F8 key will unremove all insertions.
  882.  
  883.         4. The Ctrl-End and Ctrl-Home keys respectively position the cursor
  884.            on the bottom and top line of the display.
  885.  
  886.         5. The Tab and Shift-Tab keys respectively shift the display right
  887.            and left, tab width columns.
  888.  
  889.         6. The ability to consider all characters significant.  (See the /Z
  890.            command line option.)
  891.  
  892.         7. If fileone or filetwo ends with a colon (:) symbol, the filename
  893.            (file name and optional extension) from the other fileone or
  894.            filetwo command line argument is appended.
  895.  
  896.         8. The ability to specify the line delimiter to use when the
  897.            composite file is written to disk by the F2 write function.  (See
  898.            the ENDOFLINE initialization file command.)
  899.